Share via


WAVEINCAPS

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure describes the capabilities of a waveform-audio input device.

Syntax

typedef struct {
  WORD wMid; 
  WORD wPid; 
  MMVERSION vDriverVersion; 
  CHAR szPname[MAXPNAMELEN]; 
  DWORD dwFormats; 
  WORD wChannels; 
  WORD wReserved1;} 
WAVEINCAPS; 

Members

  • wMid
    Manufacturer identifier for the device driver for the waveform-audio input device.
  • wPid
    Product identifier for the waveform-audio input device.
  • vDriverVersion
    Version number of the device driver for the waveform-audio input device. The high-order byte is the major version number, and the low-order byte is the minor version number.
  • szPname
    Null-terminated string that contains the product name.

    The length of szPname is defined by the following macro in Mmsystem.h:

    #define MAXPNAMELEN 32 /* max product name length (including NULL) */

  • dwFormats
    Specifies the standard formats that are supported. It is one or a combination of the following flags.

    Flag Description

    WAVE_FORMAT_1M08

    11.025 kHz, mono, 8-bit

    WAVE_FORMAT_1M16

    11.025 kHz, mono, 16-bit

    WAVE_FORMAT_1S08

    11.025 kHz, stereo, 8-bit

    WAVE_FORMAT_1S16

    11.025 kHz, stereo, 16-bit

    WAVE_FORMAT_2M08

    22.05 kHz, mono, 8-bit

    WAVE_FORMAT_2M16

    22.05 kHz, mono, 16-bit

    WAVE_FORMAT_2S08

    22.05 kHz, stereo, 8-bit

    WAVE_FORMAT_2S16

    22.05 kHz, stereo, 16-bit

    WAVE_FORMAT_4M08

    44.1 kHz, mono, 8-bit

    WAVE_FORMAT_4M16

    44.1 kHz, mono, 16-bit

    WAVE_FORMAT_4S08

    44.1 kHz, stereo, 8-bit

    WAVE_FORMAT_4S16

    44.1 kHz, stereo, 16-bit

  • wChannels
    Number that specifies whether the device supports mono (1) or stereo (2) input.
  • wReserved1
    Padding.

Remarks

Manufacturer and product identifiers are used in Windows-based desktop systems to allow applications to determine which devices are installed on a host computer. Although these identifiers are supported in Windows Embedded CE, they are rarely needed or used because embedded devices typically have built-in devices with built-in drivers.

Requirements

Header mmsystem.h
Windows Embedded CE Windows CE 2.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Waveform Audio Structures